home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / ya2side8.zip / ya2sider.doc < prev    next >
Text File  |  1994-06-11  |  14KB  |  481 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.              Yet another 2 sider printing program
  11.  
  12.  
  13.  
  14.                               or
  15.  
  16.  
  17.  
  18.                           Save a tree
  19.  
  20.  
  21.  
  22.                  Copyright (c) 1994 by Ted Medin
  23.  
  24.     Introduction                         3 
  25.  
  26.     Types of documents                     3 
  27.  
  28.     Unformated                          3 
  29.  
  30.     Pages formatted  by form length             4 
  31.  
  32.     Pages formatted by a form feed              4 
  33.  
  34.     Types of printers                     4 
  35.  
  36.     Printing on part of the form                 5 
  37.  
  38.     Printing on the complete form.                 6 
  39.  
  40.     Program operation                     6 
  41.  
  42.         b option                     6 
  43.  
  44.         d option                     6 
  45.  
  46.         f option                     6 
  47.  
  48.         i option                     7 
  49.  
  50.         l option                     7 
  51.  
  52.         o option                     7 
  53.  
  54.         p option                     7 
  55.  
  56.         r option                     7 
  57.  
  58.         s option                     7 
  59.  
  60.         t option                     8 
  61.  
  62.         w option                     8 
  63.  
  64.         ? option                     8 
  65.  
  66.         filename                     8 
  67.  
  68.     Examples                         9 
  69.  
  70.     Unformated document to a page printer              9 
  71.  
  72.     Unformated input printed on a fan fold printer         9 
  73.  
  74.     Formatted (form length) input on a page printer     10 
  75.  
  76.     Formatted (using ff) input on a fan fold printer     10 
  77.  
  78.     Formatted (using ff) input to a page printer         10 
  79.  
  80.     Disclaimer                         10 
  81.  
  82.     Contact                         11 
  83.  
  84.     Trade marks                         12 
  85.  
  86.  
  87. Introduction
  88.  
  89. This is one of those things i didn't want to do but after trying
  90. all the programs that supposedly did two sided printing &
  91. failing i dove in. My problem was a HP paintjet page printer &
  92. after spending much time on this program decided i would share
  93. it with you. But first thing's first: I love the Lord Jesus
  94. Christ so first i thank him for the strength & mind to do things
  95. like this. Fell in love with Him a good many years ago and He
  96. has been better to me than i deserve all these years. Favorite
  97. verse is Heb 7:25; second i got into digital computing in 1955
  98. so have been around for a bit but the mind isn't completely
  99. gone. My intention is to serve some of you out there that find
  100. this program useful. If you find ya2sider useful for private use
  101. send me a card, think kindly of me or whatever. If you find this
  102. useful for business, government or commercial then we got to
  103. share the wealth, so contact me about same. Also if you find
  104. bugs i would appreciate a report, there are many different
  105. printers out there so doubt if all are covered.
  106.  
  107. Types of documents
  108.  
  109. Ya2sider will attempt to handle three types of documents:
  110.  
  111. Unformated 
  112.  
  113. So you want to get a listing of a program, document ... Ya2sider
  114. will break the printing into pages & you can optionally have an
  115. info line on the top or bottom of the page. The optional info
  116. line can be made up of text you supply, file name, page number &
  117. date of this run. You can even specify the order of these items
  118. on the line. Pages formatted  by form length
  119.  
  120. This is the situation where someone has created a document that
  121. is exactly form length lines long (usually 66). It has blanks
  122. before the text & blanks after the text. Usually has its own
  123. info line or page numbers ... Ya2sider will also allow you to
  124. add the info line described above if there is room on the page.
  125.  
  126. Pages formatted by a form feed 
  127.  
  128. This is the situation where someone has created a document that
  129. is formatted from the start of the page & then a ff (form feed)
  130. is used to get to the next page. Ya2sider will allow you to add
  131. the info line described above if there is room on the page.
  132.  
  133. Types of printers
  134.  
  135. I have a HP paintjet xl & a HP paintjet. The xl is the page
  136. printer & the power up defaults allow you to print on 60 lines
  137. of the page but not the top or bottom margin. While the other
  138. paintjet runs fan fold & at power up defaults will print on any
  139. line of the page including top & bottom margin.  Perhaps a picture will help the understanding:
  140.  
  141.    ___    _________________________________________
  142.  
  143.     ^     |                                        |
  144.  
  145.     |     |           top margin                   |
  146.  
  147.     |     |                                        |
  148.  
  149.     |     |________________________________________|
  150.  
  151.           |                                        |
  152.  
  153.           |                                        |
  154.  
  155.     fl    |                                        |
  156.  
  157.           |                                        |
  158.  
  159.           |                                        |
  160.  
  161.     |                  printed page
  162.  
  163.     |
  164.  
  165.     |     |                                        |
  166.  
  167.     |     |                                        |
  168.  
  169.     |     |                                        |
  170.  
  171.     |     |                                        |
  172.  
  173.     |     |________________________________________|
  174.  
  175.     |     |                                        |
  176.  
  177.     |     |            bottom margin               |
  178.  
  179.     V     |                                        |
  180.  
  181.    ___    |________________________________________|
  182.  
  183.                   fl = form length in lines
  184.  
  185. Printing on part of the form
  186.  
  187. The xl prints only in the printed page area. If you have a
  188. printer like this you must inform ya2sider that the top & bottom
  189. margins are zero (0). So set options b & o to 0. For this type
  190. of printer the f (fl above) option (see below) need not be the
  191. sum of the b, o & p options. You also must inform ya2sider about
  192. the max line length that the printer can print. If your printer
  193. has proportional fonts then it's almost a sure thing ya2sider
  194. will get into line length problems (user beware).  Your printer probably has default left & right margins on the
  195. page which may influence the r & l options. Remember the r
  196. option is the left margin for even pages. Your printer also may
  197. wrap or truncate a line that is too long. Ya2sider will attempt
  198. to diagnose this but user beware.
  199.  
  200. Printing on the complete form.
  201.  
  202. Some printers print on the complete form. Ya2sider must be
  203. informed about the top/bottom margins that you or your document
  204. would like. So set options b, o, f & p appropriately. You may
  205. want to wait until the end of the analysis phase (see below) &
  206. adjust these 4 options to get the pages to print correctly. F
  207. (fl above) is the form length & must equal the sum of p, b & o.
  208.  
  209. Program operation
  210.  
  211. The program has a number of options & is called as follows:
  212.  
  213.  
  214.  
  215. ya2sider [option(s)] filename
  216.  
  217.  
  218.  
  219. b option
  220.  
  221. This is the Bottom margin and is specified -b# (where # is the
  222. number of blank lines).
  223.  
  224. d option
  225.  
  226. This is the Define info line option. The presence & order you
  227. place the sub options determines the format of the info line:
  228.  
  229.     f-input File name
  230.  
  231.     i-text input from I option
  232.  
  233.     p-Page & number
  234.  
  235.     t-Time/date of this run
  236.  
  237. f option
  238.  
  239. This is the Form length option & is the number of lines on the
  240. form. Specified by -f# i option
  241.  
  242. This is the Info line option and has three sub fields:
  243.  
  244.     b-put info line at Bottom of page
  245.  
  246.     t-put info line at Top of page
  247.  
  248.     text-your text for the info line
  249.  
  250. The b/t must appear immediately after the i & if the text
  251. contains any blanks the complete option must be enclosed in "s.
  252. Also some special characters in the text may require the "s.
  253.  
  254. l option
  255.  
  256. This is the Left margin for odd pages. When printing two sides
  257. if possible have the l option larger than the r option margin.
  258. The idea is to have blank paper in the right place in case you
  259. want to bind your pages.
  260.  
  261. o option
  262.  
  263. This is the tOp margin of page and is specified -o# (where # is
  264. the number of blank lines).
  265.  
  266. p option
  267.  
  268. This is the Page length on form, in lines. Specified -p#
  269.  
  270. r option
  271.  
  272. This is the left margin for even pages, see l option above.
  273.  
  274. s option
  275.  
  276. This option Specifies where to send the output. Sub options are:
  277.  
  278.     f<text>-text specifies the output File name OR you may specify
  279. a device - debug use to see how the program is formatting your
  280. input file? Or if you specify a device we check for the usual
  281. devices (aux, com[1-4], con, lpr[1-3] & prn) & assume you have a
  282. printer attached. Then the program acts like the output was to
  283. stdprn but sends the output to the device.
  284.  
  285.     p-stdprn, primary Printer
  286.  
  287.     s-stdout, output to Screen - you may want to use this for debug
  288. before printing a hardcopy. t option
  289.  
  290. This specifies the number of columns per Tab stop -t#
  291.  
  292. w option
  293.  
  294. Width